<html>
<head><meta charset="utf-8"><title>overview chapter · t-compiler/wg-rustc-dev-guide · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/index.html">t-compiler/wg-rustc-dev-guide</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html">overview chapter</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="182016772"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182016772" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182016772">(Nov 27 2019 at 13:08)</a>:</h4>
<p>HackMD created <a href="https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng" target="_blank" title="https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng">https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng</a></p>



<a name="182029490"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182029490" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182029490">(Nov 27 2019 at 15:31)</a>:</h4>
<p><span class="user-group-mention" data-user-group-id="1380">@WG-learning</span> ^^^ This is the doc for the overview chapter... please add your questions to it</p>



<a name="182031989"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182031989" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182031989">(Nov 27 2019 at 16:00)</a>:</h4>
<p>I added some initial thoughts, but I am not 100% sure of their correctness...</p>



<a name="182034932"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182034932" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182034932">(Nov 27 2019 at 16:30)</a>:</h4>
<p>Thank you! I add a section for a flowchart of the same just in case we forget</p>



<a name="182037833"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182037833" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182037833">(Nov 27 2019 at 16:59)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> I'm having now thoughts about <code>Overview</code> and <code>Walkthrough</code></p>



<a name="182037884"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182037884" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182037884">(Nov 27 2019 at 16:59)</a>:</h4>
<p>what do you guys consider that should be included in one and in the other?</p>



<a name="182044664"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182044664" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182044664">(Nov 27 2019 at 18:17)</a>:</h4>
<p>From what I understand, Overview is abstract steps and Walkthrough is by example code(s).</p>



<a name="182044674"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182044674" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182044674">(Nov 27 2019 at 18:17)</a>:</h4>
<p>Not sure if I my understanding correct.</p>



<a name="182056196"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056196" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056196">(Nov 27 2019 at 20:32)</a>:</h4>
<p>I was actually wondering if it makes sense to have them as two separate chapters... I was thinking we could just have 1</p>



<a name="182056220"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056220" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056220">(Nov 27 2019 at 20:32)</a>:</h4>
<p>yes, this is what I meant too</p>



<a name="182056269"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056269" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056269">(Nov 27 2019 at 20:33)</a>:</h4>
<p>you can probably describe some things in the abstract but then go into a concrete example</p>



<a name="182056754"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056754" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056754">(Nov 27 2019 at 20:38)</a>:</h4>
<p>I was thinking of two chapters because I was hoping to have multiple levels of code examples.</p>



<a name="182056762"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056762" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056762">(Nov 27 2019 at 20:38)</a>:</h4>
<p>From simpler to more complex</p>



<a name="182056813"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056813" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056813">(Nov 27 2019 at 20:39)</a>:</h4>
<p>If we merge these two into one, I would love to have sub-chapters for an example each under this. What do you think?</p>



<a name="182056846"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056846" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056846">(Nov 27 2019 at 20:40)</a>:</h4>
<p>I'd say that as soon as we figure out this first thing we can think about the rest ?</p>



<a name="182056925"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/182056925" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> amanjeev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#182056925">(Nov 27 2019 at 20:40)</a>:</h4>
<p>Oh sure! I am not saying we have to get to that this second. <span aria-label="slight smile" class="emoji emoji-1f642" role="img" title="slight smile">:slight_smile:</span> Sorry if I came off that way.</p>



<a name="190920962"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/190920962" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#190920962">(Mar 17 2020 at 22:49)</a>:</h4>
<p>Hi all, I updated the overview section notes a lot. In particular, I broke out two sections (1) what the compiler does to your code  and (2) how it does it. Please let me know what you think of this organization</p>



<a name="191264749"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191264749" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191264749">(Mar 20 2020 at 16:12)</a>:</h4>
<p>Any thoughts?</p>



<a name="191268183"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191268183" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191268183">(Mar 20 2020 at 16:37)</a>:</h4>
<p>gonna read it again</p>



<a name="191271357"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191271357" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191271357">(Mar 20 2020 at 16:59)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> everything is <a href="https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng" target="_blank" title="https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng">https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng</a> right?</p>



<a name="191271371"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191271371" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191271371">(Mar 20 2020 at 16:59)</a>:</h4>
<p>gonna read it again later</p>



<a name="191271628"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191271628" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191271628">(Mar 20 2020 at 17:01)</a>:</h4>
<p>Yes, thanks!</p>



<a name="191374677"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191374677" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191374677">(Mar 22 2020 at 01:49)</a>:</h4>
<p>This is shaping up great <span class="user-mention" data-user-id="198054">@mark-i-m</span> !</p>



<a name="191375762"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191375762" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191375762">(Mar 22 2020 at 02:19)</a>:</h4>
<p>Do you think that it is far enough along to push the document to a branch of the <code>rustc-dev-guide</code> repository?  I'd like to point to the working branch in the blog post if possible</p>



<a name="191419485"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191419485" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191419485">(Mar 22 2020 at 22:24)</a>:</h4>
<p>Hmm... I guess it could be</p>



<a name="191419552"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/191419552" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#191419552">(Mar 22 2020 at 22:26)</a>:</h4>
<p>Personally, I vaguely prefer the hackmd, but I do see the benefits of gh for getting feedback</p>



<a name="192097446"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192097446" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192097446">(Mar 28 2020 at 01:07)</a>:</h4>
<p>Anyone else interested in the lexer &amp; parser sections? If not, I can work on those areas.</p>



<a name="192306182"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192306182" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192306182">(Mar 30 2020 at 19:32)</a>:</h4>
<p><span class="user-mention silent" data-user-id="262810">Chris Simpkins</span> <a href="#narrow/stream/196385-t-compiler.2Fwg-learning/topic/overview.20chapter/near/192097446" title="#narrow/stream/196385-t-compiler.2Fwg-learning/topic/overview.20chapter/near/192097446">said</a>:</p>
<blockquote>
<p>Anyone else interested in the lexer &amp; parser sections? If not, I can work on those areas.</p>
</blockquote>
<p>Centril and I are getting together later this week to discuss the parser.  I'll begin adding parser Overview documentation after the meeting.</p>



<a name="192761214"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192761214" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192761214">(Apr 03 2020 at 06:02)</a>:</h4>
<p>WIP: <a href="https://github.com/rust-lang/rustc-dev-guide/pull/659" title="https://github.com/rust-lang/rustc-dev-guide/pull/659">https://github.com/rust-lang/rustc-dev-guide/pull/659</a> (based on <span class="user-mention" data-user-id="198054">@mark-i-m</span> branch)</p>



<a name="192852652"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192852652" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192852652">(Apr 03 2020 at 19:24)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> Do you want to periodically merge commits in other PR's into your downstream repository so that we can base changes on your open PR branch or is there a better approach?  Do you have access to push your open PR branch into an upstream working branch so that we can continue to rebase on it as changes get pulled in?</p>



<a name="192863105"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863105" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863105">(Apr 03 2020 at 20:58)</a>:</h4>
<p>Hi <span class="user-mention" data-user-id="262810">@Chris Simpkins</span> I was wondering about that too. It's a bit tricky</p>



<a name="192863227"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863227" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863227">(Apr 03 2020 at 20:59)</a>:</h4>
<p>I can make a branch on the rustc-dev-guide repo, but we will lose all of the review history already there and the link from the blog post will be wrong</p>



<a name="192863468"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863468" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863468">(Apr 03 2020 at 21:01)</a>:</h4>
<p>I think the easiest would be either</p>
<ol>
<li>for me merge your changes into the current PR branch</li>
<li>to merge my PR and rebase yours onto master</li>
</ol>
<p>between the two, I prefer 1. I think you WG members should also have permission to push onto my branch too</p>



<a name="192863796"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863796" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863796">(Apr 03 2020 at 21:04)</a>:</h4>
<p>or alternately, we could just keep going with the two different PRs and have one big rebase at the end?</p>



<a name="192863870"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863870" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863870">(Apr 03 2020 at 21:05)</a>:</h4>
<p>actually, I'm starting to lean towards (2) and open a bunch of followup PRs</p>



<a name="192863884"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863884" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863884">(Apr 03 2020 at 21:05)</a>:</h4>
<p>(1) works for me too.  I am fine with whatever approach works best on your end.  I am only trying to avoid significant merge conflicts. I have no concerns about frequent merges and opening new PR's.</p>



<a name="192863892"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863892" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863892">(Apr 03 2020 at 21:05)</a>:</h4>
<p>or (2) ... <span aria-label="slight smile" class="emoji emoji-1f642" role="img" title="slight smile">:slight_smile:</span></p>



<a name="192863898"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192863898" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192863898">(Apr 03 2020 at 21:05)</a>:</h4>
<p>^^^</p>



<a name="192864242"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192864242" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192864242">(Apr 03 2020 at 21:08)</a>:</h4>
<p>Hmm let me post on your PR thread then. If it's ok with petrochenkov/centril/matklad, I guess we can try (1) which seems simplest and go to other models if it doesn't work</p>



<a name="192864260"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192864260" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192864260">(Apr 03 2020 at 21:09)</a>:</h4>
<p>I think that will minimize conflicts</p>



<a name="192864281"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192864281" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192864281">(Apr 03 2020 at 21:09)</a>:</h4>
<p>and you should have access to my branch so you can make changes for parsing and lexing as needed</p>



<a name="192864428"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/192864428" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#192864428">(Apr 03 2020 at 21:11)</a>:</h4>
<p>Ty!  I will rebase once I see how you handle it.  I should have another PR this weekend with the parser text.</p>



<a name="193220741"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193220741" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193220741">(Apr 07 2020 at 17:23)</a>:</h4>
<p>I spoke with @matklad today about the lexer Overview.  I’ll update the Overview section this evening.  I have enough information to begin work on the Guide lexer / parser chapter edits at this stage too.</p>



<a name="193271982"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193271982" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193271982">(Apr 08 2020 at 03:20)</a>:</h4>
<p>Thanks <span class="user-mention" data-user-id="262810">@Chris Simpkins</span>!</p>



<a name="193271990"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193271990" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193271990">(Apr 08 2020 at 03:20)</a>:</h4>
<p>I think there is a question we should collectively address: how much detail should the overview have?</p>



<a name="193272002"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193272002" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193272002">(Apr 08 2020 at 03:21)</a>:</h4>
<p>e.g. I feel that the current amount/detail of content is sufficient, but perhaps others feel it is too high-level?</p>



<a name="193272004"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193272004" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193272004">(Apr 08 2020 at 03:21)</a>:</h4>
<p>cc <span class="user-group-mention" data-user-group-id="1380">@WG-rustc-dev-guide</span> ^^</p>



<a name="193272043"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193272043" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193272043">(Apr 08 2020 at 03:22)</a>:</h4>
<p>I think we should nail this down so that we are all on the same page</p>



<a name="193319615"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193319615" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193319615">(Apr 08 2020 at 13:30)</a>:</h4>
<p>hmmm, isn't it supposed to be high level so we can go into details on each section chapter?</p>



<a name="193324525"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193324525" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193324525">(Apr 08 2020 at 14:05)</a>:</h4>
<p><span class="user-mention silent" data-user-id="116266">Santiago Pastorino</span> <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/overview.20chapter/near/193319615" title="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/overview.20chapter/near/193319615">said</a>:</p>
<blockquote>
<p>hmmm, isn't it supposed to be high level so we can go into details on each section chapter?</p>
</blockquote>
<p>SGTM.  We have a detailed outline for much of the Overview now.  Do we want to decide what bits should stay and what should transition into the chapters?  For the stages, maybe a one / two liner summary, entry point link, and Guide chapter link?</p>



<a name="193324873"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193324873" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193324873">(Apr 08 2020 at 14:08)</a>:</h4>
<p>Part of the problem that I had is that it just isn't quite as simple as a one/two liner <span aria-label="slight smile" class="emoji emoji-1f642" role="img" title="slight smile">:slight_smile:</span></p>



<a name="193324921"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193324921" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193324921">(Apr 08 2020 at 14:08)</a>:</h4>
<p>:)</p>



<a name="193324947"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193324947" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193324947">(Apr 08 2020 at 14:08)</a>:</h4>
<p>I'll need to re-read the chapter</p>



<a name="193334526"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193334526" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193334526">(Apr 08 2020 at 15:15)</a>:</h4>
<p>I should probably also re read the whole thing. Perhaps at next week's meeting we can go by paragraph/bullet (1min per) and vote to add more, shorten, or leave unchanged</p>



<a name="193339271"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193339271" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193339271">(Apr 08 2020 at 15:48)</a>:</h4>
<p>Hmm, so I just gave it a reread, and I do feel that we have the right amount of details in the list of steps and shouldn't add more. In fact, I think we should maybe even move some of the content on the cmd line parser to the rustc driver chapter. e.g. I don't feel that we should mention entry points are specific structs in the list of steps (we don't even mention TyCtxt)</p>



<a name="193339409"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193339409" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193339409">(Apr 08 2020 at 15:49)</a>:</h4>
<p>I would even go so far as to say we should try to address the todos in the current document and then ship it</p>



<a name="193339588"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193339588" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193339588">(Apr 08 2020 at 15:50)</a>:</h4>
<p>I can update the sections that I wrote to address those comments this evening.  Will push a new PR with the updates.  I'll need to take a look through the <code>rustc_interface</code> chapter to see where things fit.</p>



<a name="193339705"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193339705" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193339705">(Apr 08 2020 at 15:51)</a>:</h4>
<p>And I plan to work on the lexer and parser chapter in the Guide.  I likely won't get to this before the weekend.</p>



<a name="193339804"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193339804" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193339804">(Apr 08 2020 at 15:51)</a>:</h4>
<p>Thanks <span class="user-mention" data-user-id="262810">@Chris Simpkins</span>! I think these will be great additions to the driver, parser, and lexer chapters!</p>



<a name="193340010"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193340010" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193340010">(Apr 08 2020 at 15:53)</a>:</h4>
<p>I've got a good deal more for the chapter itself after the discussions with _@centril and _@matklad.   Let's see what I can come up with.  They both offered to review when it is ready.</p>



<a name="193340361"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193340361" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193340361">(Apr 08 2020 at 15:55)</a>:</h4>
<p>I'm at the stage where it would be helpful to dive into the source and start tinkering with it to really understand it.  Trying to identify some relatively straightforward lexer/parser issues to work on.  The chapter will shape up as I do that.</p>



<a name="193340725"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193340725" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193340725">(Apr 08 2020 at 15:58)</a>:</h4>
<p>That reminds me that we still have content from a discussion with petrochenkov about macro expansion and hygiene that needs to be turned into a proper chapter too</p>



<a name="193340753"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193340753" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193340753">(Apr 08 2020 at 15:58)</a>:</h4>
<p>/me realizes how big the compiler is...</p>



<a name="193340877"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193340877" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bjorn3 <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193340877">(Apr 08 2020 at 15:59)</a>:</h4>
<div class="codehilite"><pre><span></span>$ tokei src/librustc*
-------------------------------------------------------------------------------
 Language            Files        Lines         Code     Comments       Blanks
-------------------------------------------------------------------------------
 BASH                   15          797          580           81          136
 Batch                   2           72           50            7           15
 C                       9         2110         1878           97          135
 C Header               19         3198         1050         1873          275
 CMake                   2          236          194           14           28
 C++                     6         3402         2506          380          516
 CSS                     4          337          285           15           37
 Dockerfile             23          419          353           18           48
 Fish                    2          156          110           11           35
 GLSL                   76        11145         7811         1510         1824
 Go                      8         5386         4396           32          958
 HTML                   70         3133         2962            0          171
 INI                     1            5            5            0            0
 JavaScript             11         1807         1342          180          285
 JSON                   24        11215        11215            0            0
 Makefile               10          398          296           12           90
 Markdown              625        37812        37812            0            0
 PowerShell              4          197          166            8           23
 Python                270        79088        60813         6507        11768
 ReStructuredText        8         2886         2886            0            0
 Ruby                    1           24           20            0            4
 Rust                 4857      2228181      1829436       231976       166769
 Shell                  80         3776         2541          546          689
 SVG                     5          855          851            2            2
 Plain Text             51        36455        36455            0            0
 TOML                  315         8273         7112          176          985
 Vim Script              1            1            1            0            0
 Vue                    20          957          905            0           52
 WebAssembly             9          188          188            0            0
 YAML                 1089        63043        61578          868          597
 Zsh                     1           50           39            8            3
-------------------------------------------------------------------------------
 Total                7618      2505602      2075836       244321       185445
-------------------------------------------------------------------------------
</pre></div>



<a name="193341717"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193341717" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bjorn3 <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193341717">(Apr 08 2020 at 16:05)</a>:</h4>
<p>Oops, ran it on a branch that symlinks rustc_codegen_cranelift. The real number is:</p>
<div class="codehilite"><pre><span></span>-------------------------------------------------------------------------------
 Language            Files        Lines         Code     Comments       Blanks
-------------------------------------------------------------------------------
 Markdown              437        13589        13589            0            0
 Rust                 1046       391360       292153        59678        39529
 TOML                   45         1110         1004            3          103
-------------------------------------------------------------------------------
 Total                1528       406059       306746        59681        39632
-------------------------------------------------------------------------------
</pre></div>



<a name="193344555"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193344555" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> centril <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193344555">(Apr 08 2020 at 16:27)</a>:</h4>
<p><span class="user-mention silent" data-user-id="198054">mark-i-m</span> <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/overview.20chapter/near/193340725" title="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/overview.20chapter/near/193340725">said</a>:</p>
<blockquote>
<p>That reminds me that we still have content from a discussion with petrochenkov about macro expansion and hygiene that needs to be turned into a proper chapter too</p>
</blockquote>
<p>You're pretty familiar with expansion too AIUI?</p>



<a name="193349911"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193349911" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193349911">(Apr 08 2020 at 17:06)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> didn't get it properly if you consider the overview chapter ready</p>



<a name="193349971"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193349971" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193349971">(Apr 08 2020 at 17:07)</a>:</h4>
<p>I meant, there's always stuff to do but we can also merge and keep improving it</p>



<a name="193364250"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193364250" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193364250">(Apr 08 2020 at 19:02)</a>:</h4>
<p><span class="user-mention" data-user-id="116266">@Santiago Pastorino</span> I think there are a few important TODOs we should address before merging, but other than that, I think it looks pretty good imho:</p>
<ul>
<li>niko or eddyb or some other all-around expert should take a look and confirm that we didn't say anything incorrect</li>
<li>we should determine what level of detail to put about cmdline args, lexer, and parser and finish those points</li>
<li>we need to confirm where trait solving and const eval happen and put in points about those</li>
<li>we should figure out what to do about the "unresolved questions" section. Do we just open an issue for them?</li>
</ul>



<a name="193530939"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193530939" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193530939">(Apr 10 2020 at 01:42)</a>:</h4>
<p>Will work on the interface, lexer, parser section over the weekend.  Let me know if you have thoughts about the level of detail.</p>



<a name="193898902"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193898902" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193898902">(Apr 14 2020 at 13:47)</a>:</h4>
<p>Quick update. Got sidetracked and haven't gotten to this yet.   Any other thoughts about the details in the Overview for these revisions?</p>



<a name="193961144"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193961144" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193961144">(Apr 14 2020 at 21:49)</a>:</h4>
<p>Oh</p>



<a name="193961162"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193961162" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193961162">(Apr 14 2020 at 21:49)</a>:</h4>
<p>So I just addressed most of the remaining comments (except for Santiago's most recent ones)</p>



<a name="193961250"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193961250" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193961250">(Apr 14 2020 at 21:50)</a>:</h4>
<p>And I cherry-picked two of <span class="user-mention" data-user-id="262810">@Chris Simpkins</span> commits because I thought we already had a little bit about parsing/lexing etc, but now I see that it was a todo</p>



<a name="193961269"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193961269" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193961269">(Apr 14 2020 at 21:51)</a>:</h4>
<p>should I just go ahead and merge the parser PR into the main one?</p>



<a name="193965785"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/193965785" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#193965785">(Apr 14 2020 at 22:38)</a>:</h4>
<p>Eh, I just went ahead and merged it into the big branch, we can streamline later as discussed in the meeting</p>



<a name="194521159"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194521159" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194521159">(Apr 18 2020 at 02:21)</a>:</h4>
<p>Ok, I addressed some comments, merged suggestions, responded to others, and added the rest to followup PR</p>



<a name="194521214"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194521214" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194521214">(Apr 18 2020 at 02:23)</a>:</h4>
<p>eddyb mentioned that they are pretty busy, so I don't think we will get a review from them soon. And we've had a bunch of other experienced contributors comment on various parts.</p>



<a name="194521215"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194521215" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194521215">(Apr 18 2020 at 02:23)</a>:</h4>
<p>I think we should go ahead and merge</p>



<a name="194521274"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194521274" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194521274">(Apr 18 2020 at 02:24)</a>:</h4>
<p>At 37 commits and 145 comments, this is probably one of the biggest PR threads we've had on this repo!</p>



<a name="194525451"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194525451" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Chris Simpkins <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194525451">(Apr 18 2020 at 04:31)</a>:</h4>
<p>SGTM!</p>



<a name="194552339"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194552339" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194552339">(Apr 18 2020 at 16:20)</a>:</h4>
<p><span aria-label="tada" class="emoji emoji-1f389" role="img" title="tada">:tada:</span> <a href="https://rustc-dev-guide.rust-lang.org/overview.html" title="https://rustc-dev-guide.rust-lang.org/overview.html">https://rustc-dev-guide.rust-lang.org/overview.html</a></p>



<a name="194552341"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194552341" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194552341">(Apr 18 2020 at 16:20)</a>:</h4>
<p>I'm so proud of it!</p>



<a name="194552961"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194552961" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Léo Lanteri Thauvin <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194552961">(Apr 18 2020 at 16:35)</a>:</h4>
<p><span aria-label="tada" class="emoji emoji-1f389" role="img" title="tada">:tada:</span> <span aria-label="clap" class="emoji emoji-1f44f" role="img" title="clap">:clap:</span></p>



<a name="194552965"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview%20chapter/near/194552965" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Léo Lanteri Thauvin <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/overview.20chapter.html#194552965">(Apr 18 2020 at 16:35)</a>:</h4>
<p>Now we need to adress the <em>TODO</em>s</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>